home *** CD-ROM | disk | FTP | other *** search
-
-
-
- rrrreeeeaaaaddddppppiiiixxxxeeeellllssss((((3333GGGG)))) rrrreeeeaaaaddddppppiiiixxxxeeeellllssss((((3333GGGG))))
-
-
-
- NNNNAAAAMMMMEEEE
- rrrreeeeaaaaddddppppiiiixxxxeeeellllssss - returns values of specific pixels
-
- CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
- lllloooonnnngggg rrrreeeeaaaaddddppppiiiixxxxeeeellllssss((((nnnn,,,, ccccoooolllloooorrrrssss))))
- sssshhhhoooorrrrtttt nnnn;;;;
- CCCCoooolllloooorrrriiiinnnnddddeeeexxxx ccccoooolllloooorrrrssss[[[[]]]];;;;
-
- PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
- _n expects the number of pixels to be read by the function.
-
- _c_o_l_o_r_s expects the array in which the pixel values are to be stored.
-
- FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
- The returned value of this function is the number of pixels actually
- read. A returned function value of 0 indicates an error, that the
- starting point is not a valid character position.
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- rrrreeeeaaaaddddppppiiiixxxxeeeellllssss attempts to read up to _n pixel values from the bitplanes in
- color map mode. It reads them into the array _c_o_l_o_r_s starting from the
- current character position along a single scan line (constant _y) in the
- direction of increasing _x. rrrreeeeaaaaddddppppiiiixxxxeeeellllssss returns the number of pixels read,
- which is the number requested if the starting point is a valid character
- position (inside the current viewport). rrrreeeeaaaaddddppppiiiixxxxeeeellllssss returns zero if the
- starting point is not a valid character position. The values of pixels
- read outside the viewport or the screen are undefined. rrrreeeeaaaaddddppppiiiixxxxeeeellllssss
- updates the current character position to one pixel to the right of the
- last one read; the current character position is undefined if the new
- position is outside the viewport.
-
- In double buffer mode, only the back buffer is read by default. On
- machines that support it, you can use rrrreeeeaaaaddddssssoooouuuurrrrcccceeee to control which buffer
- is read.
-
- The system must be in color map mode for rrrreeeeaaaaddddppppiiiixxxxeeeellllssss to function
- correctly.
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- lrectread, readsource
-
- NNNNOOOOTTTTEEEESSSS
- rrrreeeeaaaaddddppppiiiixxxxeeeellllssss should not be used in new development. Rather, pixels should
- be read using the high-performance llllrrrreeeeccccttttrrrreeeeaaaadddd command.
-
- This routine is available only in immediate mode.
-
- The upper bits of a color value (an element of the _c_o_l_o_r_s array) are
- undefined. You can write this information to the frame buffer without
- problems. However, if you intend to interpret this data, be sure you
- mask out the upper bits.
-
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- rrrreeeeaaaaddddppppiiiixxxxeeeellllssss((((3333GGGG)))) rrrreeeeaaaaddddppppiiiixxxxeeeellllssss((((3333GGGG))))
-
-
-
- BBBBUUUUGGGGSSSS
- On IRIS-4D GT and GTX models, when reading pixels from the PUPMODE
- planes, the returned bits are shifted up by two bits.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-